home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / archiver / mta_vf35.zip / MTA__TEC.EXE / COMMENTS.TEC < prev    next >
Text File  |  1993-02-22  |  7KB  |  133 lines
  1. ------------------------------------------------------------------------
  2. Subject : The way MTA handles comments inside archives
  3. Target  : BBS users
  4. Date    : 09-03-92
  5. Rev.    : 1.01 / 11-14/92
  6. ------------------------------------------------------------------------
  7.  
  8. Several questions have been asked about how to implement comments inside
  9. archives. Some users reported failing comments (parts of the old comment
  10. appended to a new comment).
  11.  
  12. When you run a BBS, you can expect a lot of different archives to be
  13. uploaded, all with different comments inside. In fact there are two
  14. kinds of comments:
  15.  
  16. - The archive-comment
  17.   Mostly an advertisement from the previous BBS, a bad way to inform
  18.   others that the file came from you. Better to include a file with
  19.   this information, because the comments are NOT compressed but the
  20.   file IS compressed;
  21.  
  22. - The descriptive comment
  23.   Most of the times, this is a file with a short description of the
  24.   archive (like the FILE_ID.DIZ standard). This TEC-note will not go
  25.   into this type of comments;
  26.  
  27. The archive comments CAN be used for something useful like a short
  28. one-liner with information about the file. You can even combine the
  29. one-liner with your own advertisement comment.
  30.  
  31. The key options that you must use are the AutoDescription option and
  32. the CarryComment option. Both can be used together, but when used in
  33. the wrong way, they can cause trashed comments inside the converted
  34. archives.
  35.  
  36. - AutoDescription
  37.   This option will cause a standard advertisement to be added to the
  38.   converted files (as an archive-comment);
  39.  
  40. - CarryComment
  41.   This option will cause MTA to 'carry' the comment from either the
  42.   old archive or from FILES.BBS 'over' to the new archive. There are
  43.   a number of ways in which this can be done:
  44.  
  45.   - Type 1 (CarryComment 1 or /CARCOM1)
  46.     MTA will take the comment from the original archive (up to 256
  47.     bytes) and will carry this over into the new archive. If you
  48.     have also set the AutoDescription, it will be appended to the
  49.     'carried' comment. Because most 'source' (or original) archives
  50.     contain an adversisement (sometimes with ANSI sequences) and
  51.     these files can vary in length from 100 bytes to several K's of
  52.     information, it is almost sure that the new comment in the
  53.     converted archive will contain only a PART of the original archive
  54.     AND (optionally) your own advertisement. This will look like trash
  55.     (a partially displayed comment and your own complete comment).
  56.     In general, there is NO usage for CarryComment type 1 unless you
  57.     know for sure that all comments in the original files should be
  58.     maintained (in which case they can not exceed 256 bytes of info);
  59.  
  60.   - Type 2 (CarryComment 2 or /CARCOM2)
  61.     This is also a tricky one and should only be used of files you
  62.     created yourself. Type 2 will take the comment from the original
  63.     archive and store up to 256 bytes. Then it will convert the
  64.     archive and after conversion, MTA will look if there is a
  65.     description inside FILES.BBS for this file. If there is, this will
  66.     replace the comment from the original archive, if there isn't, the
  67.     original comment is used.
  68.     If you use this type (type 2) for uploaded files of various kinds,
  69.     you are bound to get a number of trashed archives. Some of the
  70.     uploads will contain FILES.BBS entries but some won't. These last
  71.     types will get a comment just like CarryComment Type 1 (part of
  72.     the original comment plus, optionally, your own advertisement);
  73.  
  74.   - Type 3 (CarryComment 3 or /CARCOM3)
  75.     The right way for all situations. MTA will not 'carry' the comment
  76.     from the original file over into the new file but if there is an
  77.     entry in FILES.BBS it will take this entry and WILL 'carry' it
  78.     over into the new archive. Your own advertisement will be appended
  79.     to the comment and you will get something like this:
  80.  
  81.     1> /------------------------------------------------------------\
  82.     1> |  This came from DISP HQ    2:512/100 - Multiline Paradise  |
  83.     1> \------------------------------------------------------------/
  84.     2> A very dynamic archive conversion program
  85.  
  86.     1> came from your advertisement file and 2> came from the FILES.BBS
  87.     file. You can also make something like this:
  88.  
  89.     1> /------------------------------------------------------------\
  90.     1> |  This came from DISP HQ    2:512/100 - Multiline Paradise  |
  91.     1> \------------------------------------------------------------/
  92.     1> A short description of the archive below:
  93.     1>
  94.     2> A very dynamic archive conversion program
  95.  
  96.     1> came from your advertisement file and 2> came from the FILES.BBS
  97.     file. The advertisement file already contains the entry that will
  98.     inform your users that the description of the file is below the
  99.     advertisement.
  100.  
  101.     If you want to store your archives on diskettes and keep a catalog
  102.     of these diskettes with CATDISK <tm> (a very good program), you
  103.     should not use the advertisement file. In that case CATDISK can
  104.     take the description from FILES.BBS, which is carried over into
  105.     your archive, and put this comment into the CATDISK database;
  106.  
  107. In general, you should try some of the options before you start the
  108. conversion on large numbers of files. A few rules about advertisement
  109. files and advertisements in general (I am a BBS USER you know):
  110.  
  111. - Don't use ANSI in advertisements. Most archive programs won't allow
  112.   a direct display of ANSI (keeps out trojan horses), so most of the
  113.   time it will look like trash;
  114.  
  115. - Keep the advertisements short. As said before, the comments inside
  116.   the archives are STORED (NOT compressed). Better to make a short
  117.   advertisement with something like this:
  118.  
  119.   [ This file came from Users Delight, see USEDEL.TXT for more info]
  120.  
  121.   And include USEDEL.TXT into the archive (in most of the cases, this
  122.   file will be COMPRESSED and NOT stored). This is better for you users
  123.   who don't have fancy MNP/LAPM modems and/or turbo-blasters but still
  124.   use ye'oll 2400 (or less) baud modems and for you to, because the
  125.   uncompressed comments, in general, take more disk-space than the
  126.   compressed advertisements.
  127.  
  128. - Only use the lower character-set (X'00'-X'127') if you know that
  129.   your files can be transferred to other platforms.
  130.  
  131. If MTA carries descriptions in the FILES.BBS-alike file into the
  132. archive, it can (and will) strip files-counters from the decriptions.
  133.